My Simple Paladin (WoW Classic 20주년 서버 & TBC 호환용)

Game Version: WoW Classic 1.15.8 (빌드 11508), 2.5.5 (빌드 20505)
Version: 1.0.0 (2026. 4. 20.)

─────────────────────────────
1. 애드온 개요
─────────────────────────────
■ My Simple Paladin은 성기사의 축복과 오라, 주요 생존 및 유틸 스킬 상태를 한눈에 파악하고 효율적으로 관리하며, 다양한 전투 로그 알림을 제공하도록 순수 Lua로 가볍게 작성된 성기사 전용 애드온입니다.

■ 현재 접속한 캐릭터가 성기사일 때만 활성화되며, 대상 직업에 맞춘 축복, 축복 대상 인원 추적, 특수 축복 및 스킬의 쿨다운/지속시간 추적, 버프 발동이나 재료 부족 등에 대한 성기사 고유 색상의 개인 채팅 알림을 제공합니다. 또한 본인 디버프, 아군 정화(또는 순화), 특수 축복 및 중재 시전, 군중 제어(심망/퇴치/참회)의 적중/실패에 대한 공개 채팅 알림을 제공합니다.

─────────────────────────────
2. 주요 기능
─────────────────────────────
■ 1차 스킬 버튼 바 (1~6번)
 - 1~4번 (직업군별 축복): 1번(전사/도적), 2번(법사/흑마/냥꾼), 3번(술사/드루/사제/기사), 4번(모든 직업)으로 구성됩니다.
 - 5번 (오라): 배운 오라 중 하나를 선택하여 시전합니다.
 - 6번 (퇴치 스킬): 악령 퇴치(미습득 시 언데드 퇴치)를 할당합니다. 현재 대상이 언데드나 악마(언데드 퇴치의 경우 언데드)일 때만 활성화되며, 아닐 때는 회색으로 처리됩니다. (회색 처리 시에도 기존의 쿨다운 및 지속시간 표시는 유지)
 - 축복 플라이아웃 메뉴: 마우스오버 시 시전 가능한 상급/일반 축복 목록이 나타나며 클릭하여 버튼에 할당할 수 있습니다.
 - Sub 축복 (좌클릭 시전용): 1~3번 버튼에 구원, 왕, 지혜, 힘의 축복을 할당하면 직업군에 맞춰 버튼 상단에 작은 서브 축복 아이콘이 생성되며, 좌클릭으로 현재 타겟에게 시전할 수 있습니다. 4번 버튼은 상급 축복 할당 시 일반 축복 아이콘이 나타납니다.
 - 우클릭 탐색 시전: 설정된 축복 버튼을 우클릭하면 해당 그룹(예시: 전사/도적)의 파티 및 공격대원을 찾아 축복이 없는 유닛에게 우선 시전합니다. (왕의 징표가 없으면 상급 대신 일반 축복 시전)
 - 축복 인원 표시: 1~3번 버튼 하단에 '버프 받은 인원/전체 인원'이 표시되며, 모든 대상이 버프를 받았다면 왼쪽 숫자도 녹색으로 표시됩니다. 하단 중앙에는 왕의 징표 보유 개수가 표시됩니다.

■ 2차 스킬 버튼 바 (1~6번)
 - 1번: 희생의 축복
 - 2번: 보호의 축복
 - 3번: 자유의 축복
 - 4번: 공백
 - 5번: 신의 축복
 - 6번: 성스러운 중재 (버튼 상단에 신앙의 징표 개수 표시)
 - 모든 버튼은 지속시간과 쿨다운을 색상 텍스트로 표시합니다.

■ 특수 축복 대상 추적기 (희생/보호/자유의 축복)
 - 2차 버튼 바 1번 버튼 아래에 본인이 시전한 '희생의 축복, 보호의 축복, 자유의 축복'의 대상을 탐색하여 아이콘과 함께 직업 고유 색상으로 그 이름을 최대 5명까지 한 줄씩 내려가며 표시합니다.

■ 중간 바 (천상의 보호막, 응징의 격노, 세트 관리 버튼)
 - 1차 바와 2차 바 사이의 여백 공간에 배치됩니다.
 - 4번 버튼 사이: 우클릭 시에 천상의 보호막(미습득 시 신의 가호)을 시전합니다. 좌클릭 연타 시 '/연속시전 [@target,help] 천상의 보호막, 희생의 축복'을 시전합니다.
 - 5번 버튼 사이: 우클릭 시에 응징의 격노를 시전합니다.
 - 6번 버튼 사이: 축복 세트 관리 및 UI 토글 버튼입니다. 저장된 축복 세트를 플라이아웃으로 불러올 수 있으며, 우클릭으로 위치 이동 잠금/해제 토글, Shift+우클릭으로 전체 프레임 크기(36~60픽셀)를 순환 조절합니다.

■ 쿨다운 및 상태: 개인 채팅 및 경보음
 - 쿨다운 중앙 알림: '희생의 축복', '보호의 축복', '자유의 축복', '신의 축복', '천상의 보호막', '성스러운 중재', '신의 계시/신의 은총', '심망/퇴치/참회', '신성 충격/신성한 방패', '천벌의 망치/퇴마술/신의 격노', '심판/신성화/성전사의 일격'의 쿨다운 완료를 스킬 아이콘과 함께 화면 중앙에 알립니다. 기본 쿨다운이 1분 이상인 스킬은 종료 10초 전에 빨간색 메시지로 사전에 알립니다.
 - 축복 지속시간 경보: 버프의 지속시간이 1분 미만으로 떨어지면 대상 유닛의 직업 색상과 함께 화면 중앙에 알립니다.
 - 재료 경보: 왕의 징표 50개 미만, 신앙의 징표 5개 미만일 때 화면 중앙에 알립니다.
 - 정의의 격노 경보: 버프가 없을 때 오라 버튼에 빨간색 테두리를 표시하며 화면 중앙에 알립니다.
 - 출력 방식을 화면 중앙 메시지 및 경보음을 재생하는 ON(RW), 화면 중앙 메시지만 출력하는 ON 중에서 선택하거나 OFF로 비활성화할 수 있습니다.
 - 경보음: 본 애드온 폴더 안에 원하는 ogg 확장자 파일을 MSP_RW.ogg로 저장하면 해당 파일을 경보음으로 사용하고, 그렇지 않다면 기본 RaidWarning.ogg를 재생합니다.

■ 전투 로그: 공개 채팅
 - 본인 디버프 적용, 아군 정화(또는 순화) 시 채팅 알림을 지원합니다.
 - 특수 축복(희생/보호/자유/신축) 및 성스러운 중재 시전 대상 알림을 지원합니다.
 - 군중 제어(심판의 망치, 악령/언데드 퇴치, 참회) 스킬을 적대적 대상에게 적중시켰거나 실패(빗맞힘 등)했을 때 스킬 링크를 포함한 알림을 지원합니다.
 - 출력 방식을 일반(SAY), 파티(PARTY), 공격대(RAID), 감정표현(EMOTE) 중에서 선택하거나 비활성화(OFF)할 수 있습니다.

─────────────────────────────
3. 명령어 및 사용 방법
─────────────────────────────
■ 기본 명령어
 - /간단기사 또는 /msp : 설정 창 열기/닫기 토글

■ 축복 세트 설정
 - /간단기사 저장 [세트 이름]: 1~4번 버튼의 현재 축복을 저장
 - /간단기사[세트 이름]: 저장된 축복 세트 불러오기 (톱니바퀴 버튼 플라이아웃에서도 지원)
 - /간단기사 삭제 [세트 이름]: 축복 세트 삭제

■ 이동 잠금/해제 및 크기 변경
 - 톱니바퀴(세트 관리) 버튼을 우클릭하여 프레임 이동 잠금 해제/잠금
 - 톱니바퀴(세트 관리) 버튼을 Shift+우클릭하여 UI 프레임 크기를 순환식으로 조절

─────────────────────────────
4. 설치 방법
─────────────────────────────
■ 아래와 같은 폴더 구조로 설치하세요.

Interface
└── AddOns
    └── MySimplePaladin
        ├── MySimplePaladin.lua
        ├── MySimplePaladin_Vanilla.toc
        ├── MySimplePaladin_TBC.toc
        ├── README.txt
        └── MSP_RW.ogg (선택 사항 - 커스텀 경보음용 파일)

■ 게임 내 '애드온' 탭에서 [My Simple Paladin]이 활성화되어 있는지 확인합니다.

─────────────────────────────
5. 주의 사항 및 팁
─────────────────────────────
■ 성기사 전용: 이 애드온은 성기사 이외의 직업으로 접속하면 동작하지 않습니다.

■ 이동 상태 제한: UI 이동 잠금이 해제된 상태(연녹색 테두리 표시)에서는 스킬 설정이나 시전이 정상 작동하지 않으므로 위치 설정 후 반드시 잠가주시기 바랍니다.

■ 축복 세트 이름은 1~2글자로 할 것을 권장합니다.

■ 전투 중에는 축복 세트를 불러올 수 없고, 직업별 축복 버튼 우클릭을 사용할 수 없습니다. 좌클릭을 통합 서브 축복 시전은 가능합니다.

─────────────────────────────
6. 변경 이력
─────────────────────────────
■ 1.0.0 (2026. 4. 20.)
 - 스마트 축복 및 편의성 (1차 바 & 중간 바): 빈 대상에게 자동 축복 시전(우클릭), 재료 부족 시 일반 축복으로 자동 대체, 설정된 축복에 맞춘 서브 축복 연동(좌클릭), 대상 조건(언데드/악마)에 따른 퇴치, 응징의 격노, 천상의 보호막(무적+희축 매크로 포함), 축복 세트 관리 버튼
 - 특수 축복 및 추적기 (2차 바 및 1/2차 바 연동): 직업군별 축복 완료 인원 현황 및 남은 징표 개수 파악, 특수 축복(희축, 보축, 자축, 신축) 및 성스러운 중재, 특수 축복(희축, 보축, 자축)이 들어간 파티/공대원(최대 5명)을 직업 색상으로 표시
 - 상태/쿨다운 (개인 채팅): 축복 1분 미만, 정의의 격노 누락, 주요 쿨기 완료 및 완료 10초 전을 알림, 누락되었던 버프를 다시 시전하면 메시지를 즉시 삭제
 - 전투 로그 (공개 채팅): 내 디버프 및 정화(순화) 내역, 특수 축복/중재 시전, 주요 CC기(심망, 퇴치, 참회)의 적중 및 실패 여부를 알림

─────────────────────────────
7. 저작권 및 이용 조건
─────────────────────────────
■ 개인 목적에 한해 자유롭게 사용 가능

■ 개발자 표기

■ 상업적 이용 및 무단 전재/재배포 금지

─────────────────────────────
8. 개발자 정보
─────────────────────────────
■ Author: Goyathlay, 20주년 기념일 펜구스의 흉포 KR 호드

■ Contact: 인게임 우편/디스코드

